home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Shareware World / Info / For Developers / DR2.1update3 / README.install < prev    next >
Text File  |  1997-06-28  |  11KB  |  294 lines
  1. June 26, 1997
  2.  
  3. This file describes the first part of installing DR2.1update3 -- the
  4. Microkernel, the Linux Server, and the Default Pager.  Once you have
  5. completed the installation of these pieces, please read and follow the
  6. instructions in the file "README.shared" for the Shared Library portion
  7. of this update.
  8.  
  9. How to install the Mach Kernel and Linux Server
  10. -----------------------------------------------
  11.  
  12. Before we go on, there is something that must be said:
  13. ** ALWAYS BE SURE TO MAKE BACKUP COPIES OF THE MACH KERNEL AND LINUX SERVER. **
  14. (especially if you already had MkLinux running, or even limping :-)
  15.  
  16. For the Mach Kernel, which normally lives in your Extensions folder, just
  17. rename the file.  For the Linux Server, vmlinux, be sure to leave a backup
  18. copy in the /mach_servers directory.  If something doesn't work right with
  19. the new kernel/server pair, you'll be able to go back to the old kernel
  20. (by renaming it back to "Mach Kernel" in your extensions folder), boot it
  21. and the previous vmlinux.
  22.  
  23.  
  24. Obtaining the kernel/server pair
  25. --------------------------------
  26.  
  27. The Mach Kernel and Linux Server can be ftp'ed from the MkLinux ftp site:
  28.     ftp://ftp.mklinux.apple.com/pub/Updates/DR2.1update3/
  29.  
  30. The Mach Kernel is gzipped (ie. compressed) and is called:
  31.     Mach_Kernel.gz
  32.  
  33. The Linux Server is also gzipped, and is called:
  34.     vmlinux.gz
  35.  
  36. These files should be available on various mirror sites as well.
  37.  
  38.  
  39. General downloading notes
  40. -------------------------
  41.  
  42. If you are using Mac OS to download files, make sure you set the format
  43. to BINARY for ftp'ing these files.
  44.  
  45. We recommend you use Fetch or similar FTP Mac OS application rather than
  46. Netscape or another Web Browser.  Some browsers are incorrectly configured,
  47. resulting in corrupted downloaded files.  Some browsers will attempt to
  48. display binary files such as the uncompressed Mach Kernel on the screen.
  49.  
  50. A copy of Fetch can be found in ftp://ftp.mklinux.apple.com/pub/FTP_tools
  51.  
  52.  
  53. The Mach Kernel
  54. ---------------
  55.  
  56. We provide a pre-built Mach Kernel in gzipped (compressed) form.  The
  57. file name on the ftp site is:
  58.     Mach_Kernel.gz
  59.  
  60. You will need to "gunzip" it (ie. uncompress it) before it is usable.
  61. Then, it must be placed in your Extensions folder, with the name:
  62.     Mach Kernel
  63.  
  64. Note, there's a space in that name, even though on the ftp site there
  65. is an underscore in the name.  Be sure to rename the file appropriately!
  66.  
  67. Note also that the gunzipped version will look like a simple document:
  68. no fancy icon, no special type or creator ID.  This is OK.  The Mach Kernel
  69. file is a document used by the MkLinux Booter.  It may not look pretty,
  70. but if it has the correct name (Mach Kernel), the right type (Document,
  71. NOT SimpleText Document) and is in the Extensions folder, the Booter will
  72. find it and launch MkLinux.
  73.  
  74. (see below for hints on how to gunzip files in both MacOS and MkLinux, and
  75. for hints on moving files between the Mac Filesystem and the MkLinux
  76. filesystem)
  77.  
  78.  
  79. The Linux Server
  80. ----------------
  81.  
  82. Like the kernel, we provide a pre-built Linux server in gzipped form.
  83. The file is:
  84.     vmlinux.gz
  85.  
  86. It too must be be gunzipped.  The linux server "lives" in your MkLinux
  87. filesystem, in the directory "/mach_servers".  Its name should be
  88.     /mach_servers/vmlinux
  89. when it's installed.  There is probably already a "vmlinux" file there,
  90. so you should probably rename the old one.
  91.  
  92. (see below for hints on how to gunzip files in both MacOS and MkLinux, and
  93. for hints on moving files between the Mac Filesystem and the MkLinux
  94. filesystem)
  95.  
  96.  
  97. The Default Pager
  98. -----------------
  99.  
  100. The Default Pager, like the Linux Server, is a mach task.  Follow the
  101. instructions for the Linux Server above, but the file is "default_pager.gz".
  102.  
  103.  
  104. Version Information
  105. -------------------
  106.  
  107. The version of the Mach Kernel and Linux Server installed on the system
  108. may be obtained through two files located in the /proc filesystem. 
  109.  
  110. To see the version string for the Mach Kernel, type:
  111.     cat /proc/osfmach3/version
  112.  
  113. To see the version string for the Linux server, type:
  114.     cat /proc/version
  115.  
  116. The dates in these two version strings should match the date at the top
  117. of this message.
  118.  
  119.  
  120. How to gunzip (ie. uncompress) files
  121. ------------------------------------
  122.  
  123. If you are running MkLinux, there are a couple ways that you can uncompress
  124. a gzipped file.  For instance, if you have vmlinux.gz, and you want
  125. to uncompress it, use the command:
  126.     gunzip vmlinux.gz
  127.  
  128. As an alternative, you could keep the original ".gz" file and use
  129. the command:
  130.     zcat vmlinux.gz > /mach_servers/vmlinux
  131. (for instance)
  132.  
  133.  
  134. If you are running MacOS, get the tool MacGzip from the ftp site:
  135.     ftp://ftp.mklinux.apple.com/pub/FTP_tools
  136.  
  137. Drag a gzipped file (such as Mach_Kernel.gz) onto the MacGzip icon.
  138. MacGzip will recognize it as a gzipped file and uncompress it.
  139.  
  140. Whichever method you use to gunzip the file, if either program "complains"
  141. about corrupt files, you'll most likely need to FTP the file again.
  142.  
  143.  
  144. How to move files between the MkLinux filesystem and the Mac OS volume
  145. ----------------------------------------------------------------------
  146. The following steps are an example of how to transfer the Mach Kernel
  147. from a MkLinux filesystem to a Mac OS volume and how to transfer a
  148. Linux Server from the Mac OS volume to the MkLinux filesystem.
  149.  
  150. All steps are performed under MkLinux and as the user root.
  151.  
  152. 1) "mount" the HFS volume. You will need to know the SCSI ID and
  153.     partition number of the HFS volume where the file is located.
  154.     For example:
  155.     
  156.     hmount /dev/sda3
  157.     
  158.     This will mount SCSI ID 0 (a=0, b=1, c=2, etc), partition 3.
  159.     You can use the disklabel utility to determine which partion
  160.     is your HFS partition:
  161.     
  162.         disklabel /dev/sda
  163.  
  164. 2) Next, change directory to where the file exists, or is to be placed in,
  165.    the HFS volume.  In this example, the file is to be placed in the Extensions
  166.    folder in the System Folder.
  167.       
  168.    hcd ":System Folder:Extensions"
  169.    
  170.    Note, HFSUTILS uses ":", not "/" to separate names in a path.  For
  171.    example, if the file was located in a folder named "MkLinux Downloads"
  172.    within the folder "My Downloads", then the path would look like
  173.    ":My Downloads:MkLinux Downloads" 
  174.           
  175. 3) The last step actually copies the file.
  176.  
  177.    hcopy -r /tmp/Mach_Kernel ":Mach Kernel"
  178.    
  179.     This will copy the file /tmp/Mach_Kernel (note the underscore) to the
  180.     file "Mach Kernel" (note the space) in the Extensions directory in
  181.     the System Folder on the HFS volume.
  182.  
  183. 4) Or, to copy a file _from_ the HFS volume to MkLinux
  184.           
  185.    hcopy -r ":vmlinux.gz" /tmp/vmlinux.gz
  186.    
  187.    This will copy the vmlinux.gz file from the current location to
  188.    vmlinux in the /tmp directory in the MkLinux filesystem.
  189.    
  190. That's it! For more information, read the hfsutils manual page
  191. (man hfsutils)
  192.  
  193.  
  194. File transfer between MkLinux and the Mac OS volume when you can't run MkLinux
  195. ------------------------------------------------------------------------------
  196. ***
  197. *** NOTE: If you use Linux Disks, be sure to get a recent version!
  198. ***       Version 1.0d5 was known to corrupt the MkLinux filesystem
  199. ***
  200.  
  201. Sometimes, you may need to manipulate the MkLinux filesystem from MacOS.
  202. Although it's not likely that you would need to do this to apply this update,
  203. there is a way to move files to and from the MkLinux filesystem when you're
  204. running MacOS.
  205.  
  206. There is a utility called LinuxDisks written by Michel Pollet.  It is
  207. currently under active development, but is quite effective.  For more
  208. information on obtaining LinuxDisks, point your web browser to:
  209.     http://w3.teaser.fr/~mpollet/LinuxDisks/
  210.  
  211. Even though you probably won't need the tool for this update, it is very
  212. handy to have around.
  213.  
  214.  
  215. Problems after Installation
  216. ---------------------------
  217. (This section is unchanged from previous updates)
  218.  
  219. Some users have reported a new update will cause the system to be
  220. "stuck" at the MkLinux Boot splash screen -- the dialog box which
  221. asks if you want to continue to boot into Mac OS or boot into
  222. MkLinux.
  223.  
  224. Here are some suggestions on how to fix this problem -
  225.  
  226. * Verify the Mach Kernel was correctly downloaded. Web Browsers sometimes
  227.   have problems; we recommend you use Fetch. Be sure the BINARY transfer
  228.   mode was set. Be sure the resulting file sizes match exactly what
  229.   is stated in this README.  Be sure the Kind is "document".
  230.   
  231. * Some 6100's with DOS cards are reported not to boot MkLinux with the
  232.   DOS card running. Try turning the card off. This can be done through its
  233.   control panel.
  234.   
  235. * Try lowering the Disk Cache size under Mac OS to 96KB or less.
  236.   This can be done through the Memory Control Panel. 
  237.   MkLinux booting is sensitive to the memory usage of Mac OS.
  238.  
  239. * Verify the system is not running RAM Doubler or a similar product. 
  240.   Also, in some configurations, Speed Doubler has been known to
  241.   conflict with the booting process. 
  242.   
  243. * Make sure Virtual Memory under Mac OS has been turned off.
  244.   The MkLinux Boot Loader extension incorrectly detects if
  245.   VM has been turned off under System 7.5.5 or later.
  246.  
  247. * For weird and unknown reasons, installing MacsBug will often allow 
  248.   a system to boot MkLinux. We're looking into why this fixes things.
  249.  
  250.  
  251. Reverting back to the previous Mach Kernel and Linux Server
  252. -----------------------------------------------------------
  253.  
  254. In case the new Mach Kernel and/or Linux server breaks more than it fixes,
  255. you can revert back to the previous version (assuming you have made backup
  256. copies).
  257.  
  258. Restoring the Mach Kernel file is easy; simply copy the backed up version
  259. to the Extensions folder - be sure the file is named "Mach Kernel" (note
  260. that there's a space in the name).
  261.  
  262. Restoring the Linux Server, vmlinux, requires a few more steps -
  263.  
  264. 1) Under Mac OS, edit the lilo.conf file to include the line
  265.          mach_options=-a
  266.  
  267.    The lilo.conf file can edited by clicking on the CUSTOM button
  268.    in the MkLinux control panel.
  269.  
  270.    If you already had a mach_options line (for other reasons), put the
  271.    "-a" at the beginning of the line, just after the "=" symbol.  Ie.
  272.     mach_options=-a -m90 video_probe=true bus_speed=44000000
  273.  
  274.    As an alternative to adding "-a" to your mach_options, you can simply
  275.    press "a" on the "splash screen" (the one with the countdown) when you're
  276.    booting MkLinux.
  277.  
  278. 2) Reboot into MkLinux
  279.  
  280. 3) MkLinux should prompt you for a new bootstrap.conf file.
  281.    Simply press <RETURN>.
  282.  
  283. 4) You will be prompted for the default pager. Press <RETURN> again.
  284.  
  285. 5) At this point you should be prompted for vmlinux (Linux Server).
  286.    Here you can make corrections (i.e. use the DELETE key) to edit
  287.    the name to the backed up version of the Linux Server. Press <RETURN>
  288.    to continue booting.
  289.  
  290. 6) The system should boot with the older version.
  291.  
  292. Once the system is up, restore the old vmlinux file as "/mach_servers/vmlinux".
  293. Don't forget to restore the "mach_options" line in the lilo.conf file.
  294.